home *** CD-ROM | disk | FTP | other *** search
/ Windows News 2010 Summer - Disc 1 / WN_Ete2010_CD1.iso / Onglet5 / Weezo / Weezo setup.exe / {code_appDir} / www / includes / artichow / README < prev    next >
Text File  |  2010-05-19  |  5KB  |  121 lines
  1.   I. Installation
  2.  II. Configuration
  3. III. Utilisation
  4.  IV. Divers
  5.  
  6.  
  7. I. Installation
  8.    ------------
  9.  
  10. *** Premi├¿re installation ***
  11.  
  12. L'installation de Artichow se r├⌐sume ├á d├⌐compresser l'archive dans le dossier
  13. de votre choix sur votre serveur. Veillez simplement ├á t├⌐l├⌐charger l'archive
  14. dont vous avez vraiment besoin (PHP 5 ou PHP 4 & 5).
  15. Notez que Artichow requiert GD 2 et PHP 4.3.0 au minimum pour fonctionner.
  16.  
  17. *** Mise ├á jour ***
  18.  
  19. Lorsque vous souhaitez mettre ├á jour Artichow avec la derni├¿re version,
  20. essayez de suivre pas ├á pas ces ├⌐tapes :
  21.    1) D├⌐compressez la derni├¿re version de Artichow dans un dossier
  22.    2) Ecrasez le fichier Artichow.cfg.php avec votre ancien fichier
  23.    3) Copiez vos patterns dans le dossier patterns/ de la nouvelle version
  24.     4) Supprimez l'ancienne version de Artichow de votre disque
  25.     5) Copiez la nouvelle version l├á o├╣ ├⌐tait l'ancienne
  26. Une fois ces cinq ├⌐tapes effectu├⌐es, vous n'aurez plus qu'├á mettre
  27. ├⌐ventuellement ├á jour vos graphiques, en fonction des derni├¿res ├⌐volutions de
  28. l'API de Artichow. Pour cela, voyez le titre "Migrer d'une version ├á l'autre"
  29. sur la page :
  30. http://www.artichow.org/documentation
  31.  
  32. II. Configuration
  33.     -------------
  34.  
  35. M├¬me si une utilisation normale de Artichow ne n├⌐cessite pas de configuration
  36. particuli├¿re, il existe un fichier Artichow.cfg.php qui permet de modifier
  37. quelques param├¿tres de la librairie.
  38. Vous pouvez notamment configurer le r├⌐pertoire vers les polices de caract├¿re
  39. en modifiant la constante ARTICHOW_FONT (par exemple en choisissant
  40. 'c:\Windows\font' si vous ├¬tes sous Windows).
  41. Vous pouvez ├⌐galement red├⌐finir la variable $fonts. Cette variable contient une
  42. liste de polices TTF (sans l'extension) pr├⌐sentes dans votre r├⌐pertoire
  43. ARTICHOW_FONT. Pour toutes les polices de cette liste, une classe du m├¬me nom
  44. est cr├⌐├⌐e. Les polices ainsi d├⌐finies peuvent ensuite ├¬tre utilis├⌐es de cette
  45. mani├¿re :
  46. <?php
  47. $font = new Verdana(12); // 12 repr├⌐sente la taille en points
  48. ?>
  49. Il existe ├⌐galement une constante ARTICHOW_DEPRECATED. Si cette constante vaut
  50. TRUE, alors un message d'erreur sera affich├⌐ lorsque vous utiliserez une
  51. fonctionnalit├⌐ d├⌐pr├⌐ci├⌐e de Artichow. A l'inverse, avec la valeur FALSE,
  52. vous pourrez continuer ├á utiliser les fonctions d├⌐pr├⌐ci├⌐es sans soucis.
  53. Cependant, dans un souci de compatibilit├⌐, il est pr├⌐f├⌐rable de mettre ├á
  54. jour vos graphiques d├¿s lors qu'un message de ce type appara├«t (et donc de
  55. laisser la constante ├á TRUE). Les fonctionnalit├⌐s d├⌐pr├⌐ci├⌐es sont toujours
  56. potentiellement susceptibles de dispara├«tre d'une version ├á l'autre de la
  57. librairie.
  58. La constante ARTICHOW_PREFIX est vide par d├⌐faut et correspond ├á un pr├⌐fixe qui
  59. est ajout├⌐ au nom de chaque classe utilis├⌐e sur Artichow. Certains noms de
  60. classe (Graph, Image, Text, Font, etc.) sont utilis├⌐s par d'autres librairies
  61. et cela peut aboutir ├á des conflits. Pour r├⌐soudre ce probl├¿me, choisissez par
  62. exemple 'xyz' comme pr├⌐fixe et toutes les classes de Artichow s'app├¿leront
  63. d├⌐sormais xyz[Nom normal]. Exemple d'utilisation de Artichow avec
  64. ARTICHOW_PREFIX ├á 'xyz' :
  65. <?php
  66. require_once "Artichow/LinePlot.class.php";
  67.  
  68. $plot = new xyzLinePlot(array(1, 2, 3));
  69. $plot->title->set('Mon graphique');
  70. $plot->title->setFont(new xyzFont4);
  71.  
  72. $graph = new xyzGraph(400, 300);
  73. $graph->add($plot);
  74. $graph->draw();
  75. ?>
  76.  
  77.  
  78. III. Utilisation
  79.      -----------
  80.  
  81. Si vous utilisez la version con├ºue exclusivement pour PHP 5, vous pouvez vous
  82. r├⌐f├⌐rer aux exemples et aux tutoriels afin de bien prendre en main la
  83. librairie.
  84. Si vous utilisez la version pour PHP 4 & 5, r├⌐f├⌐rez vous ├⌐galement aux exemples
  85. et tutoriels mais fa├«tes attention lors de l'inclusion des fichiers de
  86. Artichow. N'incluez pas les fichiers de cette mani├¿re :
  87. <?php
  88. // Ceci ne fonctionnera pas
  89. require_once "Artichow/php5/LinePlot.class.php";
  90. // Cela non plus
  91. require_once "Artichow/php4/LinePlot.class.php";
  92. ?>
  93. Pr├⌐f├⌐rez plut├┤t :
  94. <?php
  95. // Fonctionnera correctement
  96. require_once "Artichow/LinePlot.class.php";
  97. ?>
  98. C'est la librairie qui se charge de s├⌐lectionner les bons fichiers en fonction
  99. de la version de PHP dont vous disposez.
  100.  
  101. IV. Divers
  102.     ------
  103.  
  104. La documentation de Artichow est disponible sur :
  105. http://www.artichow.org/documentation
  106.  
  107. Des tutoriels sont accessibles sur :
  108. http://www.artichow.org/tutorial
  109.  
  110. Un forum de support peut ├¬tre trouv├⌐ sur :
  111. http://www.artichow.org/forum/
  112.  
  113. N'oubliez pas que Artichow est dans le domaine public. Vous pouvez donc faire
  114. CE QUE VOUS SOUHAITEZ avec cette librairie, y compris ajouter votre nom dans
  115. chaque fichier, et la redistribuer ainsi.
  116.  
  117. Si vous souhaitez aider et participer au d├⌐veloppement de Artichow, n'h├⌐sitez
  118. pas ├á consulter cette page :
  119. http://www.artichow.org/help
  120.  
  121.